home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr13 / read502.zip / READINIT.DOC < prev    next >
Text File  |  1995-01-02  |  11KB  |  212 lines
  1. READINIT.DOC
  2. 01/02/95
  3.  
  4. The READINIT.EXE program creates and maintains a file called READ.INI.  The
  5. READ.INI file is used to override certain defaults used by READ.EXE as well as
  6. any self-viewing file created by READMAKE.EXE.
  7.  
  8. The specific defaults that can be changed:
  9.  
  10. * Printer port:  Typically defaults to LPT1:  but can be redefined to another
  11.   port or even a file name
  12.  
  13. * Printer string for regular text:  Allows you to specify the string that will
  14.   be sent to the printer port if text is printed and all lines in the document
  15.   are 80 characters or less in length.
  16.  
  17. * Printer string for wide text:  Allows you to specify the string that will be
  18.   sent to the printer if text is printed and any lines in the document are over
  19.   80 characters in length.
  20.  
  21. * String after partial document printed:  Allows you to specify what string
  22.   should be printed after a full document is printed.  This can include a page
  23.   eject character and/or printer reset information.
  24.  
  25. * String after full document printed:  Allows you to specify what string should
  26.   be printed after a full document is printed.  This can include a page eject
  27.   character and/or printer reset information.  Defaults to /012 which is a
  28.   page eject.
  29.  
  30. * Color settings:  You can change the four color sets used while viewing
  31.   documents within the program.
  32.  
  33. The routine maintains a (short) list of printer brands and some of the more
  34. useful reset strings used for different modes.  (Ask for the HPLJ settings to
  35. get an idea.) This table can be expanded if people ask.  Contact Wayne Software
  36. at the address below; provide a list of required codes for all desirable
  37. choices.  Be reasonable with the number of choices.  In any case, you can always
  38. fill in any non-predefined codes that you want to.
  39.  
  40. READINIT (and READ) look for the initialization file in your default
  41. subdirectory first.  It then searches for it in the subdirectory where the
  42. executable was and then goes through your DOS path.
  43.  
  44. The READ.INI file is further described in READ.DOC.
  45.  
  46.  
  47. Syntax:
  48.  
  49.     READINIT [ /MONO | /COLOR ]
  50.       [ Iinitfile | /-I ] [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ]
  51.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  52.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  53.  
  54. where:
  55.  
  56. "/MONO" (or "/-COLOR") forces monochrome mode
  57.  
  58. "/COLOR" (or "/-MONO") switches to color mode; the default
  59.  
  60. "/Iinitfile" says to read an initialization file with the file name "initfile".
  61. The file specification *must* contain a period.  If no drive or path information
  62. is specified, the program will search for initfile beginning in your default
  63. subdirectory and then going throughout your DOS path.  The use of an
  64. initialization file is optional.  Initially defaults to "/IREAD.INI".
  65.  
  66. "/-I" (or "/INULL") says to skip loading the READ.INI initialization file.
  67.  
  68. "/PORT=port" specifies the printer port to use for printing.  This typically
  69. defaults to /PORT=LPT1: although this can be overridden by the READ.INI file.
  70.  
  71. "/PTYPE=name" specifies the name of the printer.  This allows you to hook into
  72. some pre-defined printer settings (contact Wayne Software with some more
  73. initialization strings if you want some added).  Currently, the only accepted
  74. printers are HPLJ, EPSON, and OTHER.
  75.  
  76. "/INITT=string"("initialize thin") provides the string that will be sent to the
  77. printer before printing if all lines in the document are 80 characters or less
  78. in length.  The string can include regular characters.  Special characters are
  79. entered by using their three-character ASCII numeric code preceded by a
  80. backslash.  "\027" is the code for the special character Escape.  You can
  81. specify /INITT=NULL if desired.  Defaults to "/INITT=NULL".
  82.  
  83. "/INITW=string" ("initialize wide") provides the string that will be sent to the
  84. printer before printing if any lines in the document (not just the section
  85. printed) exceed 80 characters in length.  See "/INITT=string" description.
  86. Defaults to "/INITW=NULL".
  87.  
  88. For a Hewlett-Packard LaserJet, the following codes would typically be used:
  89.         /INITT=\027E             (portrait mode, 80 column)
  90.         /INITW=\027E\027(s16.66H (portrait mode, 132 column)
  91.  
  92. "/AFTERP=string" specifies the string to print after a partial document is
  93. printed.  This string can include a page eject character ("\012") or any printer
  94. reset codes ("\012\027E") you want.  Initially defaults to "/AFTERP=\012".
  95.  
  96. "/AFTERF=string" specifies the string to print after a full document is printed.
  97. See "/AFTERP=string" description.  Defaults to "/AFTERF=\012".
  98.  
  99.  
  100. "/COLOR=nnn nnn nnn nnn" specifies the color settings to use for (in order) (1)
  101. regular text, (2) the status line, (3) marked text, and (4) found text.  Each
  102. setting must consist of three digits, the first two being the foreground color
  103. and the last being the background color.  The foreground color should be padded
  104. on the left with a 0 if it is only one digit in length.  Defaults to "/COLOR=150
  105. 151 157 143".
  106.  
  107. Foreground colors:
  108.  
  109.         Low intensity           High intensity
  110.  
  111.         0 = black                8 = dark grey
  112.         1 = blue                 9 = light blue
  113.         2 = green               10 = light green
  114.         3 = cyan                11 = light cyan
  115.         4 = red                 12 = light red
  116.         5 = magenta             13 = light magenta
  117.         6 = brown               14 = light yellow
  118.         7 = white               15 = bright white
  119.  
  120. Adding 16 to any color will make the text blink.  Background colors can consist
  121. of 0 to 7 above.  Bright white on blue, for example, would be "151".
  122.  
  123. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  124.  
  125.  
  126. Author:
  127.  
  128. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  129. and redistribution provided relevant documentation is kept with the program, no
  130. changes are made to the program or documentation, and it is not bundled with
  131. commercial programs or charged for separately.  People who need to bundle it in
  132. for-sale packages must pay a $50 registration fee to "Wayne Software" at the
  133. following address.
  134.  
  135. Additional information about this and other Wayne Software programs can be found
  136. in the file BRUCEymm.DOC which should be included in the original ZIP file.
  137. ("ymm" is replaced by the last digit of the year and the two digit month of the
  138. release.  BRUCE312.DOC came out in December 1993.  This same naming convention
  139. is used in naming the ZIP file that this program was included in.) Comments and
  140. suggestions can also be sent to:
  141.  
  142.                 Bruce Guthrie
  143.                 Wayne Software
  144.                 113 Sheffield St.
  145.                 Silver Spring, MD 20910
  146.  
  147.                 fax: (301) 588-8986
  148.  
  149. See BRUCEymm.DOC file for additional contact information.
  150.  
  151. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  152.  
  153.  
  154. Decimal and hexadecimal codes:
  155.   e.g. "\066\097\116" and "&H426174" both are "Bat"
  156. +---------------------------------------------------------------------------
  157. | dec  hex chr | dec  hex chr | dec  hex chr | dec  hex chr | dec  hex chr |
  158. +--------------+--------------+--------------+--------------+--------------+
  159. | \000 &H00 nul| \052 &H34 4  | \104 &H68 h  | \156 &H9C £  | \208 &HD0 ╨  |
  160. | \001 &H01   | \053 &H35 5  | \105 &H69 i  | \157 &H9D ¥  | \209 &HD1 ╤  |
  161. | \002 &H02   | \054 &H36 6  | \106 &H6A j  | \158 &H9E ₧  | \210 &HD2 ╥  |
  162. | \003 &H03   | \055 &H37 7  | \107 &H6B k  | \159 &H9F ƒ  | \211 &HD3 ╙  |
  163. | \004 &H04   | \056 &H38 8  | \108 &H6C l  | \160 &HA0 á  | \212 &HD4 ╘  |
  164. | \005 &H05   | \057 &H39 9  | \109 &H6D m  | \161 &HA1 í  | \213 &HD5 ╒  |
  165. | \006 &H06   | \058 &H3A :  | \110 &H6E n  | \162 &HA2 ó  | \214 &HD6 ╓  |
  166. | \007 &H07 bel| \059 &H3B ;  | \111 &H6F o  | \163 &HA3 ú  | \215 &HD7 ╫  |
  167. | \008 &H08 bs | \060 &H3C <  | \112 &H70 p  | \164 &HA4 ñ  | \216 &HD8 ╪  |
  168. | \009 &H09 tab| \061 &H3D =  | \113 &H71 q  | \165 &HA5 Ñ  | \217 &HD9 ┘  |
  169. | \010 &H0A lf | \062 &H3E >  | \114 &H72 r  | \166 &HA6 ª  | \218 &HDA ┌  |
  170. | \011 &H0B vt | \063 &H3F ?  | \115 &H73 s  | \167 &HA7 º  | \219 &HDB █  |
  171. | \012 &H0C pg | \064 &H40 @  | \116 &H74 t  | \168 &HA8 ¿  | \220 &HDC ▄  |
  172. | \013 &H0D cr | \065 &H41 A  | \117 &H75 u  | \169 &HA9 ⌐  | \221 &HDD ▌  |
  173. | \014 &H0E   | \066 &H42 B  | \118 &H76 v  | \170 &HAA ¬  | \222 &HDE ▐  |
  174. | \015 &H0F   | \067 &H43 C  | \119 &H77 w  | \171 &HAB ½  | \223 &HDF ▀  |
  175. | \016 &H10   | \068 &H44 D  | \120 &H78 x  | \172 &HAC ¼  | \224 &HE0 α  |
  176. | \017 &H11   | \069 &H45 E  | \121 &H79 y  | \173 &HAD ¡  | \225 &HE1 ß  |
  177. | \018 &H12   | \070 &H46 F  | \122 &H7A z  | \174 &HAE «  | \226 &HE2 Γ  |
  178. | \019 &H13   | \071 &H47 G  | \123 &H7B {  | \175 &HAF »  | \227 &HE3 π  |
  179. | \020 &H14   | \072 &H48 H  | \124 &H7C |  | \176 &HB0 ░  | \228 &HE4 Σ  |
  180. | \021 &H15   | \073 &H49 I  | \125 &H7D }  | \177 &HB1 ▒  | \229 &HE5 σ  |
  181. | \022 &H16   | \074 &H4A J  | \126 &H7E ~  | \178 &HB2 ▓  | \230 &HE6 µ  |
  182. | \023 &H17   | \075 &H4B K  | \127 &H7F   | \179 &HB3 │  | \231 &HE7 τ  |
  183. | \024 &H18   | \076 &H4C L  | \128 &H80 Ç  | \180 &HB4 ┤  | \232 &HE8 Φ  |
  184. | \025 &H19   | \077 &H4D M  | \129 &H81 ü  | \181 &HB5 ╡  | \233 &HE9 Θ  |
  185. | \026 &H1A eof| \078 &H4E N  | \130 &H82 é  | \182 &HB6 ╢  | \234 &HEA Ω  |
  186. | \027 &H1B esc| \079 &H4F O  | \131 &H83 â  | \183 &HB7 ╖  | \235 &HEB δ  |
  187. | \028 &H1C   | \080 &H50 P  | \132 &H84 ä  | \184 &HB8 ╕  | \236 &HEC ∞  |
  188. | \029 &H1D ???| \081 &H51 Q  | \133 &H85 à  | \185 &HB9 ╣  | \237 &HED φ  |
  189. | \030 &H1E ???| \082 &H52 R  | \134 &H86 å  | \186 &HBA ║  | \238 &HEE ε  |
  190. | \031 &H1F ???| \083 &H53 S  | \135 &H87 ç  | \187 &HBB ╗  | \239 &HEF ∩  |
  191. | \032 &H20    | \084 &H54 T  | \136 &H88 ê  | \188 &HBC ╝  | \240 &HF0 ≡  |
  192. | \033 &H21 !  | \085 &H55 U  | \137 &H89 ë  | \189 &HBD ╜  | \241 &HF1 ±  |
  193. | \034 &H22 "  | \086 &H56 V  | \138 &H8A è  | \190 &HBE ╛  | \242 &HF2 ≥  |
  194. | \035 &H23 #  | \087 &H57 W  | \139 &H8B ï  | \191 &HBF ┐  | \243 &HF3 ≤  |
  195. | \036 &H24 $  | \088 &H58 X  | \140 &H8C î  | \192 &HC0 └  | \244 &HF4 ⌠  |
  196. | \037 &H25 %  | \089 &H59 Y  | \141 &H8D ì  | \193 &HC1 ┴  | \245 &HF5 ⌡  |
  197. | \038 &H26 &  | \090 &H5A Z  | \142 &H8E Ä  | \194 &HC2 ┬  | \246 &HF6 ÷  |
  198. | \039 &H27 '  | \091 &H5B [  | \143 &H8F Å  | \195 &HC3 ├  | \247 &HF7 ≈  |
  199. | \040 &H28 (  | \092 &H5C \  | \144 &H90 É  | \196 &HC4 ─  | \248 &HF8 °  |
  200. | \041 &H29 )  | \093 &H5D ]  | \145 &H91 æ  | \197 &HC5 ┼  | \249 &HF9 ∙  |
  201. | \042 &H2A *  | \094 &H5E ^  | \146 &H92 Æ  | \198 &HC6 ╞  | \250 &HFA ·  |
  202. | \043 &H2B +  | \095 &H5F _  | \147 &H93 ô  | \199 &HC7 ╟  | \251 &HFB √  |
  203. | \044 &H2C ,  | \096 &H60 `  | \148 &H94 ö  | \200 &HC8 ╚  | \252 &HFC ⁿ  |
  204. | \045 &H2D -  | \097 &H61 a  | \149 &H95 ò  | \201 &HC9 ╔  | \253 &HFD ²  |
  205. | \046 &H2E .  | \098 &H62 b  | \150 &H96 û  | \202 &HCA ╩  | \254 &HFE ■  |
  206. | \047 &H2F /  | \099 &H63 c  | \151 &H97 ù  | \203 &HCB ╦  | \255 &HFF    |
  207. | \048 &H30 0  | \100 &H64 d  | \152 &H98 ÿ  | \204 &HCC ╠  |              |
  208. | \049 &H31 1  | \101 &H65 e  | \153 &H99 Ö  | \205 &HCD ═  |              |
  209. | \050 &H32 2  | \102 &H66 f  | \154 &H9A Ü  | \206 &HCE ╬  |              |
  210. | \051 &H33 3  | \103 &H67 g  | \155 &H9B ¢  | \207 &HCF ╧  |              |
  211. +--------------+--------------+--------------+--------------+--------------+
  212.